home *** CD-ROM | disk | FTP | other *** search
/ AM/FM: Amiga Musicians' Freeware Magazine 7 / AM-FM 7.adf / utilities / OctaMEDPlayer / OctaMEDPlayer.doc.pp / OctaMEDPlayer.doc
Encoding:
Text File  |  1992-06-14  |  4.9 KB  |  112 lines
  1.                   OctaMEDPlayer V3.00 instructions
  2.                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. OctaMEDPlayer  is  a  stand-alone  player program for playing songs made in
  5. OctaMED.   You  may  freely  distribute this with your songs, and it can be
  6. started from both CLI and Workbench.
  7.  
  8. OctaMEDPlayer  V3.0  can load sng+samples-format and MMD0/MMD1-modules made
  9. in  MED V2.10 or later, or any version of OctaMED.  It can't load MED songs
  10. or  files  created with previous versions of MED (1.12 or 2.0).  I think it
  11. is  more  important  that OctaMEDPlayer is as compact and quick as possible
  12. instead  of  the  ability  to  load  millions  of  file  formats, there are
  13. dedicated  player  programs  for that (e.g.  MultiPlayer).  You can convert
  14. older  files by loading them to OctaMED and saving them back again.  Please
  15. note  that  there  may  be problems with playing speed when loading modules
  16. saved  with MED V2.10.  In that case, load the module into OctaMED, correct
  17. the  tempo2 (change to 6) and save it back.  Also, a bug in the module save
  18. routine  of MED 3.00 causes some modules to crash when played.  You can fix
  19. the modules by loading the module into OctaMED and saving the file back.
  20.  
  21. OctaMEDPlayer can play "standard" four channel Amiga songs, MIDI songs, 5 -
  22. 8 channel OctaMED songs, and multi-modules.
  23.  
  24. Powerpacked MMD0/MMD1 modules are automatically decrunched (powerpacker
  25. library required).
  26.  
  27. OctaMEDPlayer  has  a nice 2.0-look and it works fine under 2.0 (as well as
  28. 1.3, of course).
  29.  
  30. CLI:
  31. ~~~~    octamedplayer <song> <num>
  32.  
  33.         <song> is optional. If not specified, OctaMEDPlayer window
  34.                appears and waits for your interaction. If <song> is
  35.                present, then the song is loaded. If it loaded OK,
  36.                then the playing will start. Press Ctrl-C to quit.
  37.  
  38.         <num>  If the <song> is a multi-module, you can select the
  39.                number of the song you want to play.
  40.  
  41.         For example:
  42.         octamedplayer multimod 2  ;plays the second song of "multimod"
  43.  
  44. Workbench:
  45. ~~~~~~~~~~
  46.         You can run OctaMEDPlayer by double-clicking its icon. To
  47.         automatically play a song when its icon is clicked, set the
  48.         icon default tool (the default setting is OctaMEDPlayer).
  49.         You can click the song icon and then shift-double click the
  50.         OctaMEDPlayer icon to play that song. OctaMEDPlayer always
  51.         opens its window when started from WB.
  52.  
  53. The OctaMEDPlayer window:
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~
  55.         When you start OctaMEDPlayer from WB or CLI without arguments,
  56.         the window appears. There are gadgets for controlling the playing:
  57.  
  58.         The string gadget       Holds the name of the current song.
  59.                                 You can load a new song by typing its path
  60.                                 and filename into this gadget.
  61.  
  62.         Play                    Starts playing the song from the beginning.
  63.  
  64.         Cont                    Plays the current song starting from the
  65.                                 point where you stopped it.
  66.  
  67.         Stop                    Stops the playing.
  68.  
  69.         MIDI:Y/N                This gadget allows you to turn MIDI on/off.
  70.                                 It has no effect when in 5 - 8 channel
  71.                                 mode!
  72.  
  73.         FReq                    Allows you to load a song by using a file-
  74.                                 requester. Note that this requires you to
  75.                                 have ASL.library V37 and AmigaDOS V37, so
  76.                                 you have to get Kickstart V2.0, before you
  77.                                 can use it.
  78.  
  79.         < >                     With these gadgets you can select the song,
  80.                                 if there's a multi-module in memory.
  81.  
  82.         There's some information displayed, when you play a song:
  83.         Sg:01/01 S:001/010 B:00/08 L0000
  84.  
  85.         "Sg" shows the number of the current song, and the total number of
  86.         songs in the current module.
  87.  
  88.         "S" shows the position and the length of the playing sequence list.
  89.  
  90.         "B" shows the current block number and the total number of blocks
  91.         in the current song.
  92.  
  93.         "L" is the current line number.
  94.  
  95. ARexx interface
  96. ~~~~~~~~~~~~~~~
  97. OctaMEDPlayer  has  a small ARexx interface, which is useful for multimedia
  98. use,  for example.  The port name is OCTAMEDPLAYER.  The following commands
  99. are recognized (not case sensitive):
  100.  
  101.     play        Plays the current module (equivalent to clicking the
  102.             "Play" button).
  103.     cont        Continue playing the current module.
  104.     stop        Stop playing.
  105.     loadmod     Loads a module (e.g. loadmod 'module').
  106.     songnum     Sets the multi-module song number (e.g. songnum 2).
  107.     getsongs    Returns the number of the songs in the current
  108.             module (1) or multi-module (> 1).
  109.     quit        Quits OctaMEDPlayer
  110.  
  111. NOTE! This text file is Public Domain and you are encouraged to pass this
  112. around via the pd,along with the OctaMEDPlayer Prog,which is also pd.